“Flexible Poll” Documentation by “dnm99” v1.2

---

“Flexible Poll”

---

Table of Contents

1. Welcome
   1. About
   2. Features
2. Installation/Upgrade
   1. Before Installation
   2. Auto Installation
   3. Manual Installation
   4. Upgrade
3. User Manual
   1. First Usage
   2. Customization
   3. Preview/Publishing
   4. Poll Results
   5. Important Notes
4. Structure
   1. JavaScript
   2. CSS Files and Structure
   3. Changelog
   4. Sources and Credits

---

1. Welcome - top

1.1 About - top

Flexible poll is a dynamic poll management system. It is flexible, because you can publish it in any height and width on any web pages, no matter asp or php based. You can create awesome polls as you wish and you can add them to your web pages easily and securely. If you don't allow to other people, they can not publish your polls on their website. There is a visual graph interface for poll results in the administrator panel and you can export poll results as .csv, .xml or .pdf files from this panel. There are also several options to preview your polls after you created them. And don't worry, this system is compatible for all browsers.

---

1.2 Features - top

---

2. Installation - top

2.1 Before Installation - top

You should create a folder in your website's root directory like 'flexible'. This would be accessed like this: "www.yourdomain.com/flexible/". Then you need to create a mysql database. Once you have your MySQL database active, you should have 4 important pieces of information:

1. Hostname (e.g. localhost)
2. Database Name (e.g. flexible)
3. Database Username
4. Database Password

---

2.2 Auto Installation - top

Installation Flexible Poll on your server is very easy with only a few clicks. First you need to create a database. Then Upload all the files from the "FlexiblePoll_1.2-Full_Package_New_Installation" folder to your server via a ftp tool (Filezilla is recommended), then just go to /installation directory on your browser and follow the instructions. It will take just 1-2 minutes to install this poll system completely. (The system also try to open the installation directory automatically in your first usage, if you upload all the files successfully. And it will automatically remove the installation folder after completing installation successfully!)

---

2.3 Manual Installation - top

1. First you need to create a database
2. Import 'db.sql' file to your database which is in the database folder
3. Open 'db_connect.php' file which is in the upload folder, enter informations about your hosting provider, then save and close the file
   
4. Upload all the files from the "FlexiblePoll_1.2-Full_Package_New_Installation" folder to your server via a ftp tool (Filezilla is recommended)
5. Open your webpage on your browser, username and password are initially both admin
6. For your security you have to change your password after login successfully !
7. That's all.. Now configure your polls and publish them on your websites. Enjoy it!

---

3.4 Upgrade - top

First, please delete all the files on your server with your ftp tool. (But don't delete your existing mysql database to save your polls.) You will find a folder named "FlexiblePoll_1.x_to_1.2-Upgrade_Package" in the archive. Then upload all the files to your server. Now go to /update directory on your browser and follow the instructions.It will take just 1-2 minutes to update this poll system completely. (The system also try to open the update directory automatically , if you upload all the files successfully. And it will automatically remove the update folder after update completed successfully!)

---

3. User Manual - top

3.1 First Usage - top

After installation completed successfully,you can login to the administration panel. (http://www.yourdomain.com/flexible/admin/)
Username: admin
Password:admin

For your security, change your password from the admin profile page.

When the poll execute for the first time, the following message will be thrown: "No poll found!". You can now create your first poll from the main page by clicking "add new poll" button. After that point, you can customize the poll and add some option to the poll by clicking "edit" button from the main page.

---

3.2 Customization - top

You can customize your polls by clicking "edit" button from the main page.

Edit Title - You can change title by clicking button.
Change Title Color - You can change the color of the title by clicking button. You have to enter hex color code for the title. (e.g. Enter #000000 for black.) Default color for the poll title is black (#000). Click here to find more hex color codes.
Hide/Show Title - You can hide or show your title before publishing it by clicking button..
Change Background Color - You can change the background color of the poll by clicking button. You have to enter hex color code for the background of the poll. (e.g. Enter #FFFFFF for white.) Default background color of the poll is gray80 (#CCC). Click here to find more hex color codes.
Add New Option - You can add new option to your polls by clicking button.
Delete Option - You can also delete options if you want by clicking button. Once you clicked this button it will prompt "Are you sure you want to permanently delete this option?". Click OK to confirm.

---

3.3 Preview/Publishing - top

There are several options to preview your poll after you created it. Go to the main page from the administration panel. Click button next to the poll, now you will see the preview options.

After you confirmed the preview of the poll, you can publish it on your webpages on any platform. Just click button and take the code.

You can place the code anywhere on your webpages. But don't forget to add your domain name to the "Defined Websites" page to allow publishing the poll on this domain name. Otherwise the poll will not be displayed, and the following error message will be thrown: "You don't have permission to publish this poll !..". You can edit this error message manually from the "forbidden.php" file.

---

3.4 Poll Results - top

You can view poll results by clicking button from the main page next to the poll. It will automatically draw a pie chart for you. You can also export the results from this page as .pdf, .xml, or .csv file, if you want.

---

3.5 Important Notes - top

- Don't forget to add your webpage(s) from the "Defined Website" page. Otherwise you can't publish your polls to your visitors.
- Change admin password for your security after first login.
- You can manually customize width or height values before inserting the publish code to your webpages. The sizes are 100% defined automatically from the system.

---

4. Structure - top

4.1 JavaScript - top

This theme imports five Javascript files.

1. jQuery
2. JQuery UI
3. dialog_form.js
4. admin_conf.js
5. flexible.polls.js

1. jQuery is a Javascript library that greatly reduces the amount of code that you must write.
2. jQuery UI is a JavaScript library that provides abstractions for low-level interaction and animation, advanced effects and high-level, themeable widgets, built on top of the jQuery JavaScript library, that can be used to build interactive web applications.
3. There are some necessary functions for Jquery UI Dialog written in dialog_form.js.
4. Some animation in this poll system is carried out from the admin_conf.js
5. Poll animation is carried out from the flexible.polls.js

---

4.2 CSS Files and Structure - top

I'm using seven CSS files in this theme:


1. lib/polls0.css - Default Theme
2. lib/polls1.css - V.1.0 Theme
3. lib/polls2.css - Blue Theme
4. lib/polls3.css - Orange Theme
5. lib/polls4.css - Green Theme
6. lib/polls5.css - Pink Theme


Many browser interpret the default behavior of html elements differently. For this reason this are also included:


7. lib/ie6.css - includes modifications for IE6
8. lib/ie8-and-down.css - includes modifications for IE6-7-8

---

4.3 Changelog - top

Version 1.2 (04.05.2013)

• Added five alternative templates for administration panel
• Visual and functional improvements made on CSS and HTML Codes
• Added some alternatives to publish your polls on your websites (Object and Php include codes)
• Added 'Language' menu item and dynamically changing ui

---

Version 1.1 (03.31.2013)

• Visual improvements made
• Some codes are rewritten for simplification.

---

4.4 Sources and Credits - top

I've used the following scripts.

• Jquery UI
• Google Chart Tools
• FPDF

---

Once again, thank you so much for purchasing this product. As I said at the beginning, I'd be glad to help you if you have any questions relating to this product. No guarantees, but I'll do my best to assist. If you have a more general question relating to the products on Codecanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.

dnm99

Go To Table of Contents

---